home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / gxccman.c < prev    next >
Encoding:
C/C++ Source or Header  |  1996-11-03  |  23.5 KB  |  764 lines
  1. /* Copyright (C) 1989, 1995, 1996 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* gxccman.c */
  20. /* Character cache management routines for Ghostscript library */
  21. #include "gx.h"
  22. #include "memory_.h"
  23. #include "gpcheck.h"
  24. #include "gserrors.h"
  25. #include "gsstruct.h"
  26. #include "gsbitops.h"
  27. #include "gsutil.h"            /* for gs_next_ids */
  28. #include "gxfixed.h"
  29. #include "gxmatrix.h"
  30. #include "gzstate.h"
  31. #include "gzpath.h"
  32. #include "gxdevice.h"
  33. #include "gxdevmem.h"
  34. #include "gxchar.h"
  35. #include "gxfont.h"
  36. #include "gxfcache.h"
  37. #include "gxxfont.h"
  38.  
  39. /* Define the descriptors for the cache structures. */
  40. private_st_cached_fm_pair();
  41. private_st_cached_fm_pair_elt();
  42. /*private_st_cached_char();*/        /* unused */
  43. private_st_cached_char_ptr();        /* unused */
  44. private_st_cached_char_ptr_elt();
  45. /* GC procedures */
  46. /* We do all the work in font_dir_enum/reloc_ptrs in gsfont.c. */
  47. /* See gxfcache.h for details. */
  48. private ENUM_PTRS_BEGIN(cc_ptr_enum_ptrs) return 0;
  49. ENUM_PTRS_END
  50. private RELOC_PTRS_BEGIN(cc_ptr_reloc_ptrs) {
  51. } RELOC_PTRS_END
  52.  
  53. /* Forward references */
  54. private gx_xfont *lookup_xfont_by_name(P6(gx_device *, gx_xfont_procs *, gs_font_name *, int, const cached_fm_pair *, const gs_matrix *));
  55. private cached_char *alloc_char(P2(gs_font_dir *, ulong));
  56. private cached_char *alloc_char_in_chunk(P2(gs_font_dir *, ulong));
  57. private void hash_remove_cached_char(P2(gs_font_dir *, uint));
  58. private void shorten_cached_char(P3(gs_font_dir *, cached_char *, uint));
  59.  
  60. /* ====== Initialization ====== */
  61.  
  62. /* Allocate and initialize the character cache elements of a font directory. */
  63. int
  64. gx_char_cache_alloc(gs_memory_t *mem, register gs_font_dir *pdir,
  65.   uint bmax, uint mmax, uint cmax, uint upper)
  66. {    /* Since we use open hashing, we must increase cmax somewhat. */
  67.     uint chsize = (cmax + (cmax >> 1)) | 31;
  68.     cached_fm_pair *mdata;
  69.     cached_char **chars;
  70.  
  71.     /* Round up chsize to a power of 2. */
  72.     while ( chsize & (chsize + 1) )
  73.       chsize |= chsize >> 1;
  74.     chsize++;
  75.     mdata = gs_alloc_struct_array(mem, mmax, cached_fm_pair,
  76.                       &st_cached_fm_pair_element,
  77.                       "font_dir_alloc(mdata)");
  78.     chars = gs_alloc_struct_array(mem, chsize, cached_char *,
  79.                       &st_cached_char_ptr_element,
  80.                       "font_dir_alloc(chars)");
  81.     if ( mdata == 0 || chars == 0 )
  82.       {    gs_free_object(mem, chars, "font_dir_alloc(chars)");
  83.         gs_free_object(mem, mdata, "font_dir_alloc(mdata)");
  84.         return_error(gs_error_VMerror);
  85.       }
  86.     pdir->fmcache.mmax = mmax;
  87.     pdir->fmcache.mdata = mdata;
  88.     pdir->ccache.memory = mem;
  89.     pdir->ccache.bmax = bmax;
  90.     pdir->ccache.cmax = cmax;
  91.     pdir->ccache.lower = upper / 10;
  92.     pdir->ccache.upper = upper;
  93.     pdir->ccache.table = chars;
  94.     pdir->ccache.table_mask = chsize - 1;
  95.     gx_char_cache_init(pdir);
  96.     return 0;
  97. }
  98.  
  99. /* Initialize the character cache. */
  100. void
  101. gx_char_cache_init(register gs_font_dir *dir)
  102. {    int i;
  103.     cached_fm_pair *pair;
  104.     char_cache_chunk *cck =
  105.       (char_cache_chunk *)gs_malloc(1, sizeof(char_cache_chunk),
  106.                     "initial_chunk");
  107.  
  108.     dir->fmcache.msize = 0;
  109.     dir->fmcache.mnext = 0;
  110.     gx_bits_cache_chunk_init(cck, NULL, 0);
  111.     gx_bits_cache_init((gx_bits_cache *)&dir->ccache, cck);
  112.     dir->ccache.bspace = 0;
  113.     memset((char *)dir->ccache.table, 0,
  114.            (dir->ccache.table_mask + 1) * sizeof(cached_char *));
  115.     for ( i = 0, pair = dir->fmcache.mdata;
  116.           i < dir->fmcache.mmax; i++, pair++
  117.         )
  118.       {    pair->index = i;
  119.         fm_pair_init(pair);
  120.       }
  121. }
  122.  
  123. /* ====== Purging ====== */
  124.  
  125. /* Purge from the character cache all entries selected by */
  126. /* a client-supplied procedure. */
  127. void
  128. gx_purge_selected_cached_chars(gs_font_dir *dir,
  129.   bool (*proc)(P2(cached_char *, void *)), void *proc_data)
  130. {    int chi;
  131.     int cmax = dir->ccache.table_mask;
  132.  
  133.     for ( chi = 0; chi <= cmax; )
  134.     {    cached_char *cc = dir->ccache.table[chi];
  135.         if ( cc != 0 && (*proc)(cc, proc_data) )
  136.           {    hash_remove_cached_char(dir, chi);
  137.             gx_free_cached_char(dir, cc);
  138.           }
  139.         else
  140.           chi++;
  141.     }
  142. }
  143.  
  144. /* ====== Font-level routines ====== */
  145.  
  146. /* Add a font/matrix pair to the cache. */
  147. /* (This is only exported for gxccache.c.) */
  148. cached_fm_pair *
  149. gx_add_fm_pair(register gs_font_dir *dir, gs_font *font, const gs_uid *puid,
  150.   const gs_state *pgs)
  151. {    register cached_fm_pair *pair =
  152.       dir->fmcache.mdata + dir->fmcache.mnext;
  153.     cached_fm_pair *mend =
  154.       dir->fmcache.mdata + dir->fmcache.mmax;
  155.  
  156.     if ( dir->fmcache.msize == dir->fmcache.mmax ) /* cache is full */
  157.     {    /* Prefer an entry with num_chars == 0, if any. */
  158.         int count;
  159.         for ( count = dir->fmcache.mmax;
  160.               --count >= 0 && pair->num_chars != 0;
  161.             )
  162.           if ( ++pair == mend )
  163.             pair = dir->fmcache.mdata;
  164.         gs_purge_fm_pair(dir, pair, 0);
  165.     }
  166.     else
  167.     {    /* Look for an empty entry.  (We know there is one.) */
  168.         while ( !fm_pair_is_free(pair) )
  169.           if ( ++pair == mend )
  170.             pair = dir->fmcache.mdata;
  171.     }
  172.     dir->fmcache.msize++;
  173.     dir->fmcache.mnext = pair + 1 - dir->fmcache.mdata;
  174.     if ( dir->fmcache.mnext == dir->fmcache.mmax )
  175.         dir->fmcache.mnext = 0;
  176.     pair->font = font;
  177.     pair->UID = *puid;
  178.     /* The OSF/1 compiler doesn't like casting a pointer to */
  179.     /* a shorter int.... */
  180.     pair->hash = (uint)(ulong)pair % 549;    /* scramble bits */
  181.     pair->mxx = pgs->char_tm.xx, pair->mxy = pgs->char_tm.xy;
  182.     pair->myx = pgs->char_tm.yx, pair->myy = pgs->char_tm.yy;
  183.     pair->num_chars = 0;
  184.     pair->xfont_tried = false;
  185.     pair->xfont = 0;
  186.     if_debug8('k', "[k]adding pair 0x%lx: font=0x%lx [%g %g %g %g] UID %ld, 0x%lx\n",
  187.           (ulong)pair, (ulong)font,
  188.           pair->mxx, pair->mxy, pair->myx, pair->myy,
  189.           (long)pair->UID.id, (ulong)pair->UID.xvalues);
  190.     return pair;
  191. }
  192.  
  193. /* Look up the xfont for a font/matrix pair. */
  194. /* (This is only exported for gxccache.c.) */
  195. void
  196. gx_lookup_xfont(const gs_state *pgs, cached_fm_pair *pair, int encoding_index)
  197. {    gx_device *dev = gs_currentdevice(pgs);
  198.     gx_device *fdev = (*dev_proc(dev, get_xfont_device))(dev);
  199.     gs_font *font = pair->font;
  200.     gx_xfont_procs *procs = (*dev_proc(fdev, get_xfont_procs))(fdev);
  201.     gx_xfont *xf = 0;
  202.  
  203.     /* We mustn't attempt to use xfonts for stroked characters, */
  204.     /* because such characters go outside their bounding box. */
  205.     if ( procs != 0 && font->PaintType == 0 )
  206.     {    gs_matrix mat;
  207.  
  208.         mat.xx = pair->mxx, mat.xy = pair->mxy;
  209.         mat.yx = pair->myx, mat.yy = pair->myy;
  210.         mat.tx = 0, mat.ty = 0;
  211.         /* xfonts can outlive their invocations, */
  212.         /* but restore purges them properly. */
  213.         pair->memory = pgs->memory;
  214.         if ( font->key_name.size != 0 )
  215.             xf = lookup_xfont_by_name(fdev, procs,
  216.                 &font->key_name, encoding_index,
  217.                 pair, &mat);
  218. #define font_name_eq(pfn1,pfn2)\
  219.   ((pfn1)->size == (pfn2)->size && (pfn1)->size != 0 &&\
  220.    !memcmp((char *)(pfn1)->chars, (char *)(pfn2)->chars, (pfn1)->size))
  221.         if ( xf == 0 && font->font_name.size != 0 &&
  222.                  /* Avoid redundant lookup */
  223.              !font_name_eq(&font->font_name, &font->key_name)
  224.            )
  225.             xf = lookup_xfont_by_name(fdev, procs,
  226.                 &font->font_name, encoding_index,
  227.                 pair, &mat);
  228.         if ( xf == 0 && font->FontType != ft_composite &&
  229.              uid_is_valid(&((gs_font_base *)font)->UID)
  230.            )
  231.         {    /* Look for an original font with the same UID. */
  232.             gs_font_dir *pdir = font->dir;
  233.             gs_font *pfont;
  234.  
  235.             for ( pfont = pdir->orig_fonts; pfont != 0;
  236.                   pfont = pfont->next
  237.                 )
  238.             {    if ( pfont->FontType != ft_composite &&
  239.                      uid_equal(&((gs_font_base *)pfont)->UID,
  240.                            &((gs_font_base *)font)->UID) &&
  241.                      pfont->key_name.size != 0 &&
  242.                      !font_name_eq(&font->key_name,
  243.                                &pfont->key_name)
  244.                    )
  245.                 {    xf = lookup_xfont_by_name(fdev, procs,
  246.                         &pfont->key_name,
  247.                         encoding_index, pair, &mat);
  248.                     if ( xf != 0 )
  249.                       break;
  250.                 }
  251.             }
  252.         }
  253.     }
  254.     pair->xfont = xf;
  255. }
  256.  
  257. /* ------ Internal routines ------ */
  258.  
  259. /* Purge from the caches all references to a given font/matrix pair, */
  260. /* or just characters that depend on its xfont. */
  261. #define cpair ((cached_fm_pair *)vpair)
  262. private bool
  263. purge_fm_pair_char(cached_char *cc, void *vpair)
  264. {    return cc_pair(cc) == cpair;
  265. }
  266. private bool
  267. purge_fm_pair_char_xfont(cached_char *cc, void *vpair)
  268. {    return cc_pair(cc) == cpair && cpair->xfont == 0 && !cc_has_bits(cc);
  269. }
  270. #undef cpair
  271. void
  272. gs_purge_fm_pair(gs_font_dir *dir, cached_fm_pair *pair, int xfont_only)
  273. {    if_debug2('k', "[k]purging pair 0x%lx%s\n",
  274.           (ulong)pair, (xfont_only ? " (xfont only)" : ""));
  275.     if ( pair->xfont != 0 )
  276.       {    (*pair->xfont->common.procs->release)(pair->xfont,
  277.                               pair->memory);
  278.         pair->xfont_tried = false;
  279.         pair->xfont = 0;
  280.       }
  281.     gx_purge_selected_cached_chars(dir,
  282.                        (xfont_only ? purge_fm_pair_char_xfont :
  283.                     purge_fm_pair_char),
  284.                        pair);
  285.     if ( !xfont_only )
  286.       {
  287. #ifdef DEBUG
  288.         if ( pair->num_chars != 0 )
  289.           {    lprintf1("Error in gs_purge_fm_pair: num_chars =%d\n",
  290.                  pair->num_chars);
  291.           }
  292. #endif
  293.         fm_pair_set_free(pair);
  294.         dir->fmcache.msize--;
  295.       }
  296. }
  297.  
  298. /* Look up an xfont by name. */
  299. /* The caller must already have done get_xfont_device to get the proper */
  300. /* device to pass as the first argument to lookup_font. */
  301. private gx_xfont *
  302. lookup_xfont_by_name(gx_device *fdev, gx_xfont_procs *procs,
  303.   gs_font_name *pfstr, int encoding_index, const cached_fm_pair *pair,
  304.   const gs_matrix *pmat)
  305. {    gx_xfont *xf;
  306.     if_debug5('k', "[k]lookup xfont %s [%g %g %g %g]\n",
  307.           pfstr->chars, pmat->xx, pmat->xy, pmat->yx, pmat->yy);
  308.     xf = (*procs->lookup_font)(fdev,
  309.                    &pfstr->chars[0], pfstr->size,
  310.                    encoding_index, &pair->UID,
  311.                    pmat, pair->memory);
  312.     if_debug1('k', "[k]... xfont=0x%lx\n", (ulong)xf);
  313.     return xf;
  314. }
  315.  
  316. /* ====== Character-level routines ====== */
  317.  
  318. /*
  319.  * Allocate storage for caching a rendered character with possible
  320.  * oversampling and/or alpha.  Return the cached_char if OK, 0 if too big.
  321.  * If the character is being oversampled, make the size decision
  322.  * on the basis of the final (scaled-down) size.
  323.  *
  324.  * The iwidth and iheight parameters include scaling up for oversampling
  325.  * (multiplication by 1 << pscale->{x,y}.)
  326.  * The depth parameter is the final number of alpha bits;
  327.  * depth <= x scale * y scale.
  328.  * If dev == NULL, this is an xfont-only entry.
  329.  * If dev != NULL, set up the memory device(s); in this case, if dev2 is
  330.  * not NULL, dev should be an alpha-buffer device with dev2 (an alpha
  331.  * device) as target.
  332.  */
  333. cached_char *
  334. gx_alloc_char_bits(gs_font_dir *dir, gx_device_memory *dev,
  335.   gx_device_memory *dev2, ushort iwidth, ushort iheight,
  336.   const gs_log2_scale_point *pscale, int depth)
  337. {    int log2_xscale = pscale->x;
  338.     int log2_yscale = pscale->y;
  339.     int log2_depth = depth >> 1;    /* works for 1,2,4 */
  340.     uint nwidth_bits = (iwidth >> log2_xscale) << log2_depth;
  341.     ulong isize, icdsize;
  342.     uint iraster;
  343.     cached_char *cc;
  344.     gx_device_memory mdev;
  345.     gx_device_memory *pdev = dev;
  346.     gx_device_memory *pdev2;
  347.  
  348.     if ( dev == NULL )
  349.     {    mdev.memory = 0;
  350.         mdev.target = 0;
  351.         pdev = &mdev;
  352.     }
  353.     pdev2 = (dev2 == 0 ? pdev : dev2);
  354.  
  355.     /* Compute the scaled-down bitmap size, and test against */
  356.     /* the maximum cachable character size. */
  357.  
  358.     iraster = bitmap_raster(nwidth_bits);
  359.     if ( iraster != 0 && iheight >> log2_yscale > dir->ccache.upper / iraster )
  360.     {    if_debug5('k', "[k]no cache bits: scale=%dx%d, raster/scale=%u, height/scale=%u, upper=%u\n",
  361.               1 << log2_xscale, 1 << log2_yscale,
  362.               iraster, iheight, dir->ccache.upper);
  363.         return 0;        /* too big */
  364.     }
  365.  
  366.     /* Compute the actual bitmap size(s) and allocate the bits. */
  367.  
  368.     if ( dev2 == 0 )
  369.       {    /* Render to a full (possibly oversampled) bitmap; */
  370.         /* compress (if needed) when done. */
  371.         gs_make_mem_mono_device(pdev, pdev->memory, pdev->target);
  372.         pdev->width = iwidth;
  373.         pdev->height = iheight;
  374.         isize = gdev_mem_bitmap_size(pdev);
  375.       }
  376.     else
  377.       {    /* Use an alpha-buffer device to compress as we go. */
  378.         gs_make_mem_alpha_device(dev2, dev2->memory, NULL, depth);
  379.         dev2->width = iwidth >> log2_xscale;
  380.         dev2->height = iheight >> log2_yscale;
  381.         gs_make_mem_abuf_device(dev, dev->memory, (gx_device *)dev2,
  382.                     pscale, depth, 0);
  383.         dev->width = iwidth;
  384.         dev->height = 2 << log2_yscale;
  385.         isize = gdev_mem_bitmap_size(dev) +
  386.           gdev_mem_bitmap_size(dev2);
  387.       }
  388.     icdsize = isize + sizeof_cached_char;
  389.     cc = alloc_char(dir, icdsize);
  390.     if ( cc == 0 )
  391.       return 0;
  392.     if_debug4('k', "[k]adding char 0x%lx:%u(%u,%u)\n",
  393.           (ulong)cc, (uint)icdsize, iwidth, iheight);
  394.  
  395.     /* Fill in the entry. */
  396.  
  397.     cc_set_depth(cc, depth);
  398.     cc->xglyph = gx_no_xglyph;
  399.     /* Set the width and height to those of the device. */
  400.     /* Note that if we are oversampling without an alpha buffer. */
  401.     /* these are not the final unscaled dimensions. */
  402.     cc->width = pdev2->width;
  403.     cc->height = pdev2->height;
  404.     cc->shift = 0;
  405.     cc_set_raster(cc, gdev_mem_raster(pdev2));
  406.     cc_set_pair_only(cc, 0);    /* not linked in yet */
  407.     cc->id = gx_no_bitmap_id;
  408.  
  409.     /* Open the cache device(s). */
  410.  
  411.     if ( dev2 )
  412.       {    /* The second device is an alpha device that targets */
  413.         /* the real storage for the character. */
  414.         byte *bits = cc_bits(cc);
  415.         uint bsize = (uint)gdev_mem_bitmap_size(dev2);
  416.  
  417.         memset(bits, 0, bsize);
  418.         dev2->base = bits;
  419.         (*dev_proc(dev2, open_device))((gx_device *)dev2);
  420.         dev->base = bits + bsize;
  421.         (*dev_proc(dev, open_device))((gx_device *)dev);
  422.       }
  423.     else if ( dev )
  424.       gx_open_cache_device(dev, cc);
  425.  
  426.     return cc;
  427. }
  428.  
  429. /* Open the cache device. */
  430. void
  431. gx_open_cache_device(gx_device_memory *dev, cached_char *cc)
  432. {    byte *bits = cc_bits(cc);
  433.  
  434.     dev->width = cc->width;
  435.     dev->height = cc->height;
  436.     memset((char *)bits, 0, (uint)gdev_mem_bitmap_size(dev));
  437.     dev->base = bits;
  438.     (*dev_proc(dev, open_device))((gx_device *)dev);    /* initialize */
  439. }
  440.  
  441. /* Remove a character from the cache. */
  442. void
  443. gx_free_cached_char(gs_font_dir *dir, cached_char *cc)
  444. {    char_cache_chunk *cck = cc->chunk;
  445.  
  446.     dir->ccache.chunks = cck;
  447.     dir->ccache.cnext = (byte *)cc - cck->data;
  448.     if ( cc_pair(cc) != 0 )
  449.        {    /* might be allocated but not added to table yet */
  450.         cc_pair(cc)->num_chars--;
  451.        }
  452.     if_debug2('k', "[k]freeing char 0x%lx, pair=0x%lx\n",
  453.           (ulong)cc, (ulong)cc_pair(cc));
  454.     gx_bits_cache_free((gx_bits_cache *)&dir->ccache, &cc->head, cck);
  455. }
  456.  
  457. /* Add a character to the cache */
  458. void
  459. gx_add_cached_char(gs_font_dir *dir, gx_device_memory *dev,
  460.   cached_char *cc, cached_fm_pair *pair, const gs_log2_scale_point *pscale)
  461. {    if_debug5('k', "[k]chaining char 0x%lx: pair=0x%lx, glyph=0x%lx, wmode=%d, depth=%d\n",
  462.           (ulong)cc, (ulong)pair, (ulong)cc->code,
  463.           cc->wmode, cc_depth(cc));
  464.     if ( dev != NULL )
  465.       {    static const gs_log2_scale_point no_scale = { 0, 0 };
  466.         /* Close the device, to flush the alpha buffer if any. */
  467.         (*dev_proc(dev, close_device))((gx_device *)dev);
  468.         gx_add_char_bits(dir, cc,
  469.                  (gs_device_is_abuf((gx_device *)dev) ?
  470.                   &no_scale : pscale));
  471.       }
  472.     /* Add the new character to the hash table. */
  473.     {    uint chi = chars_head_index(cc->code, pair);
  474.         while ( dir->ccache.table[chi &= dir->ccache.table_mask] != 0 )
  475.           chi++;
  476.         dir->ccache.table[chi] = cc;
  477.         cc_set_pair(cc, pair);
  478.         pair->num_chars++;
  479.     }
  480. }
  481.  
  482. /* Adjust the bits of a newly-rendered character, by unscaling */
  483. /* and compressing or converting to alpha values if necessary. */
  484. void
  485. gx_add_char_bits(gs_font_dir *dir, cached_char *cc,
  486.   const gs_log2_scale_point *plog2_scale)
  487. {    int log2_x = plog2_scale->x, log2_y = plog2_scale->y;
  488.     uint raster = cc_raster(cc);
  489.     byte *bits = cc_bits(cc);
  490.     int depth = cc_depth(cc);
  491.     int log2_depth = depth >> 1;    /* works for 1,2,4 */
  492.     uint nwidth_bits, nraster;
  493.     gs_int_rect bbox;
  494.  
  495. #ifdef DEBUG
  496.     if ( cc->width % (1 << log2_x) != 0 ||
  497.          cc->height % (1 << log2_y) != 0
  498.        )
  499.       {    lprintf4("size %d,%d not multiple of scale %d,%d!\n",
  500.              cc->width, cc->height,
  501.              1 << log2_x, 1 << log2_y);
  502.         cc->width &= -1 << log2_x;
  503.         cc->height &= -1 << log2_y;
  504.       }
  505. #endif
  506.  
  507.     /*
  508.      * Compute the bounding box before compressing.
  509.      * We may have to scan more bits, but this is a lot faster than
  510.      * compressing the white space.  Note that all bbox values are
  511.      * in bits, not pixels.
  512.      */
  513.  
  514.     bits_bounding_box(bits, cc->height, raster, &bbox);
  515.  
  516.     /*
  517.      * If the character was oversampled, compress it now.
  518.      * In this case we know that log2_depth <= log2_x.
  519.      * If the character was not oversampled, or if we converted
  520.      * oversampling to alpha dynamically (using an alpha buffer
  521.      * intermediate device), log2_x and log2_y are both zero,
  522.      * but in the latter case we may still have depth > 1.
  523.      */
  524.  
  525.     if ( (log2_x | log2_y) != 0 )
  526.       {    if_debug5('k', "[k]compressing %dx%d by %dx%d to depth=%d\n",
  527.               cc->width, cc->height, 1 << log2_x, 1 << log2_y,
  528.               depth);
  529.         if ( gs_debug_c('K') )
  530.           debug_dump_bitmap(bits, raster, cc->height,
  531.                     "[K]uncompressed bits");
  532.         /* Truncate/round the bbox to a multiple of the scale. */
  533.         { int scale_x = 1 << log2_x;
  534.           bbox.p.x &= -scale_x;
  535.           bbox.q.x = (bbox.q.x + scale_x - 1) & -scale_x;
  536.         }
  537.         { int scale_y = 1 << log2_y;
  538.           bbox.p.y &= -scale_y;
  539.           bbox.q.y = (bbox.q.y + scale_y - 1) & -scale_y;
  540.         }
  541.         cc->width = (bbox.q.x - bbox.p.x) >> log2_x;
  542.         cc->height = (bbox.q.y - bbox.p.y) >> log2_y;
  543.         nwidth_bits = cc->width << log2_depth;
  544.         nraster = bitmap_raster(nwidth_bits);
  545.         bits_compress_scaled(bits + raster * bbox.p.y, bbox.p.x,
  546.                      cc->width << log2_x,
  547.                      cc->height << log2_y,
  548.                      raster,
  549.                      bits, nraster, plog2_scale, log2_depth);
  550.         bbox.p.x >>= log2_x;
  551.         bbox.p.y >>= log2_y;
  552.       }
  553.     else
  554.       {    /* No oversampling, just remove white space. */
  555.         const byte *from = bits + raster * bbox.p.y + (bbox.p.x >> 3);
  556.  
  557.         cc->height = bbox.q.y - bbox.p.y;
  558.         /*
  559.          * We'd like to trim off left and right blank space,
  560.          * but currently we're only willing to move bytes, not bits.
  561.          * (If we ever want to do better, we must remember that
  562.          * we can only trim whole pixels, and a pixel may occupy
  563.          * more than one bit.)
  564.          */
  565.         bbox.p.x &= ~7;            /* adjust to byte boundary */
  566.         bbox.p.x >>= log2_depth;    /* bits => pixels */
  567.         bbox.q.x = (bbox.q.x + depth - 1) >> log2_depth;  /* ditto */
  568.         cc->width = bbox.q.x - bbox.p.x;
  569.         nwidth_bits = cc->width << log2_depth;
  570.         nraster = bitmap_raster(nwidth_bits);
  571.         if ( bbox.p.x != 0 || nraster != raster )
  572.           {    /* Move the bits down and over. */
  573.             byte *to = bits;
  574.             uint n = cc->height;
  575.             /* We'd like to move only 
  576.                 uint nbytes = (nwidth_bits + 7) >> 3;
  577.              * bytes per scan line, but unfortunately this drops
  578.              * the guaranteed zero padding at the end.
  579.              */
  580.  
  581.             for ( ; n--; from += raster, to += nraster )
  582.               memmove(to, from, /*nbytes*/nraster);
  583.           }
  584.         else if ( bbox.p.y != 0 )
  585.           {    /* Just move the bits down. */
  586.             memmove(bits, from, raster * cc->height);
  587.           }
  588.       }        
  589.  
  590.     /* Adjust the offsets to account for removed white space. */
  591.  
  592.     cc->offset.x -= int2fixed(bbox.p.x);
  593.     cc->offset.y -= int2fixed(bbox.p.y);
  594.  
  595.     /* Discard the memory device overhead that follows the bits, */
  596.     /* and any space reclaimed from unscaling or compression. */
  597.  
  598.     cc_set_raster(cc, nraster);
  599.     {    uint diff = round_down(cc->head.size - sizeof_cached_char -
  600.                          nraster * cc->height,
  601.                        align_cached_char_mod);
  602.  
  603.         if ( diff >= sizeof(cached_char_head) )
  604.         {    shorten_cached_char(dir, cc, diff);
  605.             if_debug2('K', "[K]shortening char 0x%lx by %u (adding)\n",
  606.                   (ulong)cc, diff);
  607.         }
  608.     }
  609.  
  610.     /* Assign a bitmap id. */
  611.  
  612.     cc->id = gs_next_ids(1);
  613. }
  614.  
  615. /* Purge from the caches all references to a given font. */
  616. void
  617. gs_purge_font_from_char_caches(gs_font_dir *dir, const gs_font *font)
  618. {    cached_fm_pair *pair = dir->fmcache.mdata;
  619.     int count = dir->fmcache.mmax;
  620.  
  621.     if_debug1('k', "[k]purging font 0x%lx\n",
  622.           (ulong)font);
  623.     while ( count-- )
  624.     {    if ( pair->font == font )
  625.         {    if ( uid_is_valid(&pair->UID) )
  626.             {    /* Keep the entry. */
  627.                 pair->font = 0;
  628.             }
  629.             else
  630.                 gs_purge_fm_pair(dir, pair, 0);
  631.         }
  632.         pair++;
  633.     }
  634. }
  635.  
  636. /* ------ Internal routines ------ */
  637.  
  638. /* Allocate data space for a cached character, adding a new chunk if needed. */
  639. private cached_char *
  640. alloc_char(gs_font_dir *dir, ulong icdsize)
  641. {    /* Try allocating at the current position first. */
  642.     cached_char *cc = alloc_char_in_chunk(dir, icdsize);
  643.  
  644.     if ( cc == 0 )
  645.     {    if ( dir->ccache.bspace < dir->ccache.bmax )
  646.         {    /* Allocate another chunk. */
  647.             char_cache_chunk *cck_prev = dir->ccache.chunks;
  648.             char_cache_chunk *cck;
  649.             uint cksize = dir->ccache.bmax / 5 + 1;
  650.             uint tsize = dir->ccache.bmax - dir->ccache.bspace;
  651.             byte *cdata;
  652.  
  653.             if ( cksize > tsize )
  654.               cksize = tsize;
  655.             if ( icdsize + sizeof(cached_char_head) > cksize )
  656.             {    if_debug2('k', "[k]no cache bits: cdsize+head=%lu, cksize=%u\n",
  657.                       icdsize + sizeof(cached_char_head),
  658.                       cksize);
  659.                 return 0;        /* wouldn't fit */
  660.             }
  661.             cck = (char_cache_chunk *)gs_malloc(1, sizeof(*cck),
  662.                             "char cache chunk");
  663.             if ( cck == 0 )
  664.               return 0;
  665.             cdata = (byte *)gs_malloc(cksize, 1,
  666.                           "char cache chunk");
  667.             if ( cdata == 0 )
  668.             {    gs_free((char *)cck, 1, sizeof(*cck),
  669.                     "char cache chunk");
  670.                 return 0;
  671.             }
  672.             gx_bits_cache_chunk_init(cck, cdata, cksize);
  673.             cck->next = cck_prev->next;
  674.             cck_prev->next = cck;
  675.             dir->ccache.bspace += cksize;
  676.             dir->ccache.chunks = cck;
  677.         }
  678.         else
  679.         {    /* Cycle through existing chunks. */
  680.             char_cache_chunk *cck_init = dir->ccache.chunks;
  681.             char_cache_chunk *cck = cck_init;
  682.             while ( (dir->ccache.chunks = cck = cck->next) != cck_init )
  683.               {    dir->ccache.cnext = 0;
  684.                 cc = alloc_char_in_chunk(dir, icdsize);
  685.                 if ( cc != 0 )
  686.                   return cc;
  687.               }
  688.         }
  689.         dir->ccache.cnext = 0;
  690.         cc = alloc_char_in_chunk(dir, icdsize);
  691.     }
  692.     return cc;
  693. }
  694.  
  695. /* Allocate a character in the current chunk. */
  696. private cached_char *
  697. alloc_char_in_chunk(gs_font_dir *dir, ulong icdsize)
  698. {    char_cache_chunk *cck = dir->ccache.chunks;
  699.     cached_char_head *cch;
  700. #define cc ((cached_char *)cch)
  701.     int code;
  702.  
  703.     while ( (code = gx_bits_cache_alloc((gx_bits_cache *)&dir->ccache,
  704.                         icdsize, &cch)) < 0
  705.           )
  706.       {    if ( cch == 0 )
  707.           {    /* Not enough room to allocate in this chunk. */
  708.             return 0;
  709.           }
  710.         {    /* Free the character */
  711.             cached_fm_pair *pair = cc_pair(cc);
  712.  
  713.             if ( pair != 0 )
  714.               {    uint chi = chars_head_index(cc->code, pair);
  715.                 while ( dir->ccache.table[chi & dir->ccache.table_mask] != cc )
  716.                   chi++;
  717.                 hash_remove_cached_char(dir, chi);
  718.               }
  719.             gx_free_cached_char(dir, cc);
  720.         }
  721.     }
  722.     cc->chunk = cck;
  723.     cc->loc = (byte *)cc - cck->data;
  724.     return cc;
  725. #undef cc
  726. }
  727.  
  728. /* Remove the cached_char at a given index in the hash table. */
  729. /* In order not to slow down lookup, we relocate following entries. */
  730. private void
  731. hash_remove_cached_char(gs_font_dir *dir, uint chi)
  732. {    uint mask = dir->ccache.table_mask;
  733.     uint from = ((chi &= mask) + 1) & mask;
  734.     cached_char *cc;
  735.  
  736.     dir->ccache.table[chi] = 0;
  737.     while ( (cc = dir->ccache.table[from]) != 0 )
  738.       {    /* Loop invariants: chars[chi] == 0; */
  739.         /* chars[chi+1..from] != 0. */
  740.         uint fchi = chars_head_index(cc->code, cc_pair(cc));
  741.  
  742.         /* If chi <= fchi < from, we relocate the character. */
  743.         /* Note that '<=' must take wraparound into account. */
  744.         if ( (chi < from ? chi <= fchi && fchi < from :
  745.               chi <= fchi || fchi < from)
  746.            )
  747.           {    dir->ccache.table[chi] = cc;
  748.             dir->ccache.table[from] = 0;
  749.             chi = from;
  750.           }
  751.         from = (from + 1) & mask;
  752.       }
  753. }
  754.  
  755. /* Shorten a cached character. */
  756. /* diff >= sizeof(cached_char_head). */
  757. private void
  758. shorten_cached_char(gs_font_dir *dir, cached_char *cc, uint diff)
  759. {    gx_bits_cache_shorten((gx_bits_cache *)&dir->ccache, &cc->head,
  760.                   diff, cc->chunk);
  761.     if_debug2('K', "[K]shortening creates free block 0x%lx(%u)\n",
  762.           (ulong)((byte *)cc + cc->head.size), diff);
  763. }
  764.